                        2005-05-12/vk, last revised 2005-06-30

Reading Metview Mail (in Metview 3.7 or later)
==============================================

Abstract
--------
 If you cannot read incoming Metview Mails then you can either
 copy mail messages to mail folder $HOME/MozMail/MvNewsMail or
 $HOME/Mail/MvNewsMail, or $HOME/nsmail/MvNewsMail, or set
 environment variable $MVNEWSMAIL or $MAIL, before starting
 Metview.

   Notes for ECMWF Users
   ---------------------
    On workstations running SuSE 9.1 (or later) Mail incoming
    folder (IMAP folder) is not visible (not mounted) any more
    to non-mail applications. As a consequence, Metview is not
    able to access your incoming mail folder. For this reason
    we have modified 'Metview Mail' access in Metview 3.7 by
    adding folder $HOME/Mail/MvNewsMail to be searched.

    NOTE: We have learned that for new Mozilla Mail users
          'Local Folders' is under $HOME/MozMail/MvNewsMail.
          Thus from now on (31 May 2005) Metview knows to
          use this file if it exists!

    NOTE2: We have learned that for old Netscape Mail users
          'Local Folders' is under $HOME/nsmail/MvNewsMail.
          Thus from now on (30 June 2005) 'metview_new' knows
          to use this file if it exists!

    If you have received 'Metview Mail' which you can see in
    your mail reader, but the mail message is not visible in
    'Metview News', then create a mail subfolder called
    'MvNewsMail' under your mail 'Local Folders' and copy
    your 'Metview Mail' message to that folder.

    NOTE:
      Even if your IMAP incoming folder is still visible, but
      if it contains hundreds of mail messages, accessing
      'Metview Mail' via 'MvNewsMail' folder is much much faster!

Mail Search Mechanism
---------------------
 Metview 'Mail' tool provides a nice way to send Metview
 icons to other Metview users. 'Metview Mail' can be read
 and any attached Metview icons extracted with 'News' tool.

 In most cases (when your Metview environment has been
 properly configured) you should not have problems accessing
 your received 'Metview Mail' with 'Metview News' tool.

 This 'Metview News' article is intended for those cases
 when you run into problems accessing your incoming 'Metview
 Mail' or if you want to know a little bit more about how
 Metview tries to locate your incoming mail from several
 possible locations.

 Metview uses environment variable MAIL to locate your
 incoming 'Metview Mail'. Also variable MVNEWSMAIL is
 checked.

 Here is the full explanation:

1)
 First Metview checks if environment variable MVNEWSMAIL
 has been set. If it has been set then Metview assumes
 that $MVNEWSMAIL points to a mail folder that contains
 your received 'Metview Mails'.

2)
 If $MVNEWSMAIL has not been set then Metview tries to find
 mail folder called $HOME/Mail/MvNewsMail. If you have a mail
 folder with such a name then Metview uses that folder. (This
 is for those ECMWF users who before Mozilla used ZMail.)

3)
 If 1) and 2) fail then Metview tries to find mail folder
 called $HOME/MozMail/MvNewsMail. If you have a mail folder
 with such a name then Metview uses that folder. (This is
 for new ECMWF users whose first mail client is Mozilla.)

3)
 If 1) to 3) fail then Metview tries to find mail folder
 called $HOME/nsmail/MvNewsMail. If you have a mail folder
 with such a name then Metview uses that folder. (This is
 for those ECMWF users whose old mail client was Netscape.)

5)
 If all previous attempts have failed then Metview checks
 if environment variable MAIL has been set. If it exists
 then Metview assumes $MAIL points to your incoming 'Metview
 Mail' folder.

6)
 If $MAIL has not been set then Metview looks for a mail folder
 /var/spool/mail/$LOGNAME (at ECMWF; if you are running Metview
 locally outside ECMWF the default may be different). If this
 last attempt fails then Metview is not able to access your
 received 'Metview Mails'.

Note:
----- 
 'Metview News' displays 'Metview Mail' only from the first
 folder located. For instance, if you create mail folder
 'MvNewsMail' and you still have older 'Metview Mails' in
 your incoming folder, Metview only shows 'Metview Mails'
 from folder 'MvNewsMail'. In such a case, either copy older
 'Metview Mails' into 'MvNewsMail', or play with environment
 variable MVNEWSMAIL.
____________________________________________________________